home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / maximus / fd2max2.zip / FD2MAX2.DOC next >
Text File  |  1996-01-18  |  5KB  |  158 lines
  1.               ┌┬┬┬┬┬┬┬┬┬┬┬┬┬┬┬┬┬┬┬───────────┬┬┬┬┬┬┬┬┬┬┬┬┬┬┬┬┬┬┬┐
  2.               ├┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼┤  FD2MAX2  ├┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼┼┤
  3.               ├┴┴┴┴┴┴┴┴┴┴┴┴┴┴┴┴┴┴┴───────────┴┴┴┴┴┴┴┴┴┴┴┴┴┴┴┴┴┴┴┤
  4.               │   Frontdoor (DOS) <---> Maximus (OS/2) bridge   │
  5.               └────────────────18th January 1996────────────────┘
  6.  
  7.  
  8. * Introduction
  9. * Requirements
  10. * How to use FD2MAX2
  11. * How much does this program cost to use?
  12. * Availability
  13. * Credits
  14.  
  15.  
  16. Introduction
  17. ============
  18.  
  19. This program has a very simple purpose in life - it reads a DOBBS.BAT file
  20. produced by a DOS mailer and passes the parameters from the batch file, along
  21. with the handle to an open com port, to an OS/2 BBS program.
  22.  
  23. FD2MAX2 was written with Frontdoor and Maximus/2 in mind, but you could use
  24. it to bridge any DOS frontend program that produces DOBBS.BAT-style dropfiles,
  25. and almost any OS/2 program that requires an open com port handle rather than
  26. a fixed port name or number.
  27.  
  28.  
  29. Requirements
  30. ============
  31.  
  32. A DOS based mailer, such as Frontdoor or Intermail, that produces a DOBBS.BAT
  33. style dropfile after answering the call.  Frontdoor must be set up to produce
  34. this file (FDSETUP->Mailer->Errorlevels->Create BAT.file).
  35.  
  36. An OS/2 based program that needs the handle to an open com port, such as
  37. Maximus/2.
  38.  
  39. This program *will* work with the standard COM.SYS driver and a DOS fossil,
  40. but from tests that we have carried out you will need to force the modem to
  41. ignore DTR to avoid dropping the line when the DOS VDM quits.  This is not a
  42. very good idea, as it makes it very difficult to hang up the modem reliably.
  43.  
  44. A much better solution is to use SIO, Ray Gwinn's excellent serial port
  45. driver.  If you are running an OS/2 based BBS package with any DOS doors then
  46. you will also want to enable comm port sharing in SIO - you can do this by
  47. adding a '-' switch in the port definitions, ie:
  48.  
  49. DEVICE = D:\SIO\SIO.SYS (1:115200,,,-)
  50.  
  51.  
  52. How to use FD2MAX2
  53. ==================
  54.  
  55. Syntax: fd2max2 <path to dobbs.bat> <command line ...>
  56.  
  57.   <command line> may contain fields from dobbs.bat, typically:
  58.         $0      "EXEBBS" or "EXEFAX"
  59.         $1      Baud rate
  60.         $2      Com port number
  61.         $3      Time remaining until next event
  62.         $4      Task number (always 0 for s/w version of Frontdoor)
  63.         $5      ARQ connect string, '/ARQ' or similar, or '/NONE' if none
  64.         $6      Caller-ID information, or 'N/A' if none
  65.         $7-$9   Undefined but available
  66.  
  67. In addition:
  68.         $H      File handle for open comport
  69.  
  70. Example syntax:
  71. fd2max \fd\dobbs.bat maxp.exe -p$H -n$4 -b$1 -s115200
  72.  
  73.  
  74. Here is a very simple example of how to use FD2MAX2 as a bridge between
  75. Frontdoor and Maximus/2:
  76.  
  77. ==== bbs.cmd ====
  78.   :start
  79.   cd \fd
  80.   fd.exe
  81.   cd \max
  82.   fd2max2 \fd\dobbs.bat maxp.exe -p$H -n$4 -b$1 -s115200
  83.   cd \fd
  84.   goto start
  85. ------ cut ------
  86.  
  87. Field $0 possibly requires explanation.  If Frontdoor receives a FAX call, it
  88. writes out a DOBBS.BAT field with 'EXEFAX' instead of 'EXEBBS'.  If you
  89. wanted to pass fax calls to another application (probably BGFAX/2), you'll
  90. need to use a slightly more complicated setup, something like this:
  91. (Note, however, that this batch file has not been tested).
  92.  
  93. ==== bbs.cmd ====
  94.   :start
  95.   cd \fd
  96.   fd.exe
  97.   cd \max
  98.   fd2max2 \fd\dobbs.bat loadbbs.cmd $0 $2 -p$H -n$4 -b$1 -s115200
  99.   cd \fd
  100.   goto start
  101. ------ cut ------
  102.  
  103. == loadbbs.cmd ==
  104.   if %1.==EXEFAX. goto fax
  105.   maxp.exe %3 %4 %5 %6
  106.   goto end
  107.   :fax
  108.   cd \bgfax
  109.   bgfax2.exe /fax \bgfax %2 z
  110.   :end
  111. ------ cut ------
  112.  
  113. However, if you do use BGFAX/2, be sure to read the section regarding SIO and
  114. locked ports in the BGFAX docs.
  115.  
  116.  
  117. How much does this program cost to use?
  118. =======================================
  119.  
  120. This is a rather small program, and although it does provides a solution to
  121. an otherwise unsolvable problem, it's far too simple to ask any money for,
  122. but we'd love to hear from you.  Of course, if you want to send us money, we
  123. won't turn it down!
  124.  
  125. So, this program can properly be classified as 'email-ware' - if you're using
  126. it, drop us a note!
  127.  
  128. We can be contacted in the following ways.  Comments, criticism, hey, even
  129. flames - we like mail! - to any of:
  130.  
  131. Fidonet:  Malcolm Rowe, 2:254/438
  132.           Mark Stewart, 2:254/276
  133.  
  134. Email:    Malcolm Rowe <malcolm@pyro.org>
  135.           Mark Stewart <mark@evolve.demon.co.uk>
  136.  
  137. BBS:      Malcolm Rowe, Pyrotechnix BBS  - +44 181 390 4701
  138.           Mark Stewart, Evolution        - +44 181 241 6607
  139.                                         or +44 181 287 2013
  140.  
  141.  
  142. Availability
  143. ============
  144.  
  145. We don't expect to make any major changes to such a simple program unless we
  146. get a lot of mail asking for a specific feature, but if there are any furthur
  147. updates, they will be available on both the above BBS's for download and FREQ.
  148. The latest version will always be available using the magic name 'FD2MAX2'.
  149.  
  150.  
  151. Credits
  152. =======
  153.  
  154.       Concept: Malcolm Rowe and Mark Stewart
  155.        Coding: Malcolm Rowe
  156. Documentation: Mark Stewart
  157.  
  158.